home *** CD-ROM | disk | FTP | other *** search
/ Shareware Universe - The Gold Collection / Shareware Universe The Gold Collection.iso / wind / inctrl / inctrl.go < prev    next >
Encoding:
Text File  |  1996-04-19  |  11.2 KB  |  223 lines
  1. INCTRL Info
  2. INCTRL.EXE (Version 1.0)            Copyright (c) 1992 Neil J. Rubenking
  3. ------------------------------------------------------------------------
  4. First Published in PC Magazine July 1992 (Utilities)
  5. ------------------------------------------------------------------------
  6.  
  7. INCTRL: 
  8.  
  9.        INCTRL.EXE is an Installation Control program for Windows. It
  10. supervises an application's install utility and writes a report file
  11. of changes made to your system.
  12.  
  13. USING INCTRL
  14.  
  15.      After copying INCTRL.EXE onto your hard disk, you can load it from
  16. Program Manager, as usual.  Note that the program requires protected
  17. mode (Windows Standard or Enhanced modes) to operate.
  18.  
  19.      It takes hardly any more effort to install a new Windows application
  20. under INCTRL's supervision than to go through the usual File, Run dialog
  21. under Program Manager.  After bringing up INCTRL, you press one button
  22. to select the install program and press a second to choose a filename
  23. for the output report. Although this documentation discusses INCTRL using
  24. a Windows 3.1 common dialog box for file selection, INCTRL does not require
  25. the COMMDLG dynamic link library. If you don't have COMMDLG.DLL on your
  26. system, INCTRL will simply use a different file selection dialog box.
  27.  
  28.      When you've selected both the install program to be run and a name
  29. for INCTRL's output report, the grayed-out Perform Install button will
  30. be enabled. Press it and INCTRL will take over the installation.
  31.  
  32.      There will be an initial delay as INCTRL memorizes the file layout
  33. of the fixed disks on your system. During this interval a small window
  34. will appear to let you know what's happening.  INCTRL also makes copies
  35. of WIN.INI and SYSTEM.INI at this time, using the names WININI.$$$ and
  36. SYSINI.$$$. After these preparations, INCTRL executes the application's
  37. install program; then you simply follow the application's instructions
  38. to complete the installation.
  39.  
  40.       After the installation is finished, INCTRL writes a header (which
  41. includes the install filename and the current date and time) for its
  42. output report. It then scans your fixed disks again, checking each file
  43. and directory against the disk contents it memorized earlier. For items
  44. already present on its list, INCTRL compares the current size and date/time
  45. stamp with their previous values. If the stamps are different, INCTRL
  46. notes that the file has changed; if they are the same, it removes the file
  47. from the list. Any file not present on the list was obviously added during
  48. the installation, so INCTRL writes its name to the output report.
  49.  
  50.      When this second scan of files and directories is complete, the
  51. only files left from INCTRL's original list will be those that were
  52. changed during the installation or those that were deleted. INCTRL first
  53. flips through the list and reports the name of every item that was marked
  54. as having been changed by the install program. Since every file that
  55. exists on-disk was either removed from the list or marked as changed,
  56. any remaining files not marked as changed must have been deleted by
  57. the install program. INCTRL reports these as well, even though it's
  58. unusual for an install program to erase files.
  59.  
  60.      Next, INCTRL compares the saved copy of WIN.INI with the current
  61. WIN.INI. It compiles a list of all the section headings from the old
  62. file and checks that list against the section headings from the new file.
  63. If any were added during the installation, it writes their names to the
  64. output report and adds them to the list. INCTRL doesn't report on sections
  65. deleted from WIN.INI. It follows the same procedure in examining
  66. SYSTEM.INI. For each section in the .INI file, INCTRL gets a list of
  67. all the keys (for example, Load) contained in that section of the old
  68. file and reports on any keys that were added in the new file.  Then it
  69. checks the value of each key from the old file against the value of
  70. that key in the new file. If they differ, it writes both the old value
  71. and the new to the output file.
  72.  
  73.      INCTRL will notify you if it finds a duplicate section name or a
  74. duplicate key within a section of an INI file. Normally, the Windows
  75. functions that create the keys don't allow creation of duplicate key
  76. names. A particular exception occurs in the [386Enh] section of
  77. SYSTEM.INI, however, which can have any number of lines with the key
  78. DEVICE. Windows accesses these lines during initialization, without
  79. going through the normal INI-handling functions. INCTRL also treats
  80. this key specially: It simply counts the number of times it occurs in
  81. the old and in the new files and reports if the new file has more
  82. DEVICE lines.
  83.  
  84.      The Figure below shows an abbreviated version of a sample INCTRL
  85. report, which was generated while installing the After Dark screen saver.
  86. That application's install program copied 81 files and 5 directories
  87. to the disk, added a DEVICE= line to SYSTEM.INI, and added the programs
  88. AD.EXE and ADINIT.EXE to the LOAD= line in WIN.INI. There are 8 files
  89. listed as changed: 3 .INI files and 5 from an earlier incomplete attempt
  90. to uninstall the program.
  91.  
  92.      Be warned that some install programs take a two-step approach that
  93. fools INCTRL: They copy a secondary install program to the hard disk
  94. and then execute that program. INCTRL thinks the installation is over
  95. when the primary program ends, so it reports that the only file added
  96. was the secondary install program. You may be able to work around this
  97. situation by using INCTRL to reexecute the secondary install program.
  98. If it reinstalls the remaining files, they'll show up as changed files
  99. in the INCTRL report.
  100.  
  101. CONFIGURING INCTRL
  102.  
  103.       By default, INCTRL scans all fixed disks on your system looking
  104. for file and directory changes. If you have one or more disk partitions
  105. that are never used for Windows applications, you can speed INCTRL's
  106. search and reduce its memory requirements by excluding those drives from
  107. examination. To do so, create the ASCII file INCTRL.INI in your Windows
  108. directory with a single section called [Excluded drives]. For each drive
  109. you want to exclude, add a key line such as c=1 to that section. For
  110. example, to exclude drives C: and D:, add the following:
  111.  
  112.                               [Excluded drives]
  113.                               c=1
  114.                               d=1
  115.  
  116.      Your Windows directory is the default storage location for INCTRL
  117. report files. To make another directory the default, add a [Directories]
  118. section to INCTRL.INI and assign that directory to the ReptDir key, as,
  119. for example:
  120.  
  121.                               [Directories]
  122.                               ReptDir=E:\INCTRL
  123.  
  124. UNINSTALLING WITH INCTRL
  125.  
  126.      Although INCTRL gives you the information you need to uninstall a
  127. program, you'll have to make some decisions based on this information.
  128. Your first step is to delete the program's icon from the Program Manager
  129. group that contains it. If the program has a group all its own, you can
  130. delete the whole group.
  131.  
  132.      Now run your favorite file manager and, into your editor of choice,
  133. load the INCTRL report for the application to be removed. Look first for
  134. entire directories added during its installation: you can usually delete
  135. these entirely. You should at least consider the possibility, however,
  136. that you may have created data files in a program-created directory that you're thinking of deleting. If you're not sure, try individually deleting
  137. the files INCTRL reports in that directory and examine any that are left
  138. over.
  139.  
  140.      You can, of course, delete a private .INI file if the program
  141. installed one, but most files added to the Windows and the System
  142. directories are intended to be shared with other programs. Thus, it
  143. may not be safe to delete .DLL, .DRV, .FON or .EXE files that were
  144. installed in either of these directories. If you want to be sure, rename
  145. rather than delete these possibly shared files and then restart Windows.
  146. Bring up each program you installed after the program being removed and
  147. make sure it doesn't depend on the renamed files. If this test succeeds,
  148. you can delete the renamed files. If one of your programs refuses to run
  149. without a particular renamed file, rename it back and add that filename
  150. to the INCTRL report for the dependent program.
  151.  
  152.      INCTRL's list of changed files is provided for your information;
  153. most of the time you won't want to delete any of these, since the
  154. installation program either updated them or simply recopied them on
  155. your disk. Either way, they were there before the installation and should
  156. probably stay after you uninstall the program.
  157.  
  158.      If changes were made to WIN.INI or SYSTEM.INI, bring up the affected
  159. .INI file in your favorite ASCII editor. A new section is much like a new
  160. directory--you can probably erase the whole thing. If one or more .EXE
  161. files were added to the LOAD= or RUN= lines in the [windows] section of
  162. WIN.INI, remove them. Don't simply restore the "before" value of the
  163. line unless you're sure that other programs have not subsequently been
  164. added to these lines. On the other hand, some programs are associated
  165. with a particular file extension in the [extensions] section. Once the
  166. program is gone, you'll probably  want to delete the WIN.INI line for
  167. that association.
  168.  
  169.      Other .INI file changes must be considered on a case-by-case basis.
  170. If you're not sure whether it's safe to delete a line, turn it into a
  171. comment by putting a semicolon at the beginning of the line. Then restart
  172. Windows and run each program that was installed after the program being
  173. removed. If they all work, you can either delete the now-commented lines
  174. or leave them in place as comments. In case you find that one of your
  175. other programs does depend on a particular .INI file line, remove the
  176. initial semicolon and add the line to the INCTRL report file for that
  177. program.
  178.  
  179. Neil J. Rubenking is technical editor of PC Magazine.
  180.  
  181. ----------------------------------------------------------------------
  182. Figure: This is an abbreviated version of the report INCTRL produced
  183. after installing the After Dark screen saver.
  184. ----------------------------------------------------------------------
  185.  
  186.                          AN INCTRL REPORT
  187.  
  188. INSTALLATION REPORT - B:\INSTALL.EXE
  189.  
  190. Produced by INCTRL, Copyright (c) 1992 by Neil J. Rubenking
  191. Wed 4/1/1992 09:20:29.06
  192.  
  193. *** FILES AND DIRECTORIES ADDED ***
  194. DIR : E:\AFTERDRK
  195. FILE: E:\WINDOWS\AFTERDAR.GRP
  196. FILE: E:\AFTERDRK\AD_LIB.DLL
  197. FILE: E:\AFTERDRK\ADINIT.EXE
  198. FILE: E:\AFTERDRK\AD.EXE
  199. . . .
  200. FILE: E:\AFTERDRK\ADMODULE.SDK\BLANKER\MNAME.RSC
  201. Install program added 81 files and 5 directories.
  202.  
  203. *** FILES AND DIRECTORIES CHANGED ***
  204. FILE: E:\WINDOWS\AD.CFG
  205. FILE: E:\WINDOWS\ADMODULE.ADS
  206. FILE: E:\WINDOWS\AD_PREFS.INI
  207. FILE: E:\WINDOWS\PROGMAN.INI
  208. FILE: E:\WINDOWS\SYSTEM.ADK
  209. FILE: E:\WINDOWS\SYSTEM.INI
  210. FILE: E:\WINDOWS\WIN.INI
  211. FILE: E:\WINDOWS\WININI.ADK
  212. Install program changed 8 files and 0 directories.
  213.  
  214. *** KEYS CHANGED IN WIN.INI SECTION [windows] ***
  215. BEFORE: load=
  216.  AFTER: load=e:\afterdrk\ad.exe e:\afterdrk\adinit.exe
  217. 1 keys changed in WIN.INI section [windows]
  218.  
  219. *** KEYS ADDED TO SYSTEM.INI SECTION [386Enh] ***
  220. 1 DEVICE= lines added to the [386Enh] section of SYSTEM.INI
  221. 1 keys added to SYSTEM.INI section [386Enh]
  222. ----------------------------------------------------------------------
  223.